Skip to content

Fix video/poster assets: use GitHub LFS media URLs#254

Merged
RafaelPo merged 1 commit intomainfrom
fix/video-lfs-urls
Feb 27, 2026
Merged

Fix video/poster assets: use GitHub LFS media URLs#254
RafaelPo merged 1 commit intomainfrom
fix/video-lfs-urls

Conversation

@RafaelPo
Copy link
Contributor

Summary

  • The deploy workflow doesn't fetch LFS files, so the docs site was serving LFS pointer files (~130 bytes) instead of actual videos and poster images
  • Replace all 6 local /docs/videos/ references with media.githubusercontent.com URLs that serve the real LFS content directly

Test plan

  • Verify all 3 videos play on /docs/mcp-server
  • Verify all 3 poster thumbnails display before playback

🤖 Generated with Claude Code

The deploy workflow doesn't fetch LFS files, so the static site was
serving LFS pointer files instead of actual video/image content.
Point directly at media.githubusercontent.com URLs instead.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@RafaelPo RafaelPo merged commit c70fc0c into main Feb 27, 2026
3 checks passed
@RafaelPo RafaelPo deleted the fix/video-lfs-urls branch February 27, 2026 23:07
Comment on lines +29 to +30
<video controls preload="metadata" poster="https://media.githubusercontent.com/media/futuresearch/everyrow-sdk/main/docs-site/public/videos/setup-claude-web-poster.jpg" style={{display: 'block', width: '100%', borderRadius: '8px', border: '1px solid #e5e7eb'}}>
<source src="https://media.githubusercontent.com/media/futuresearch/everyrow-sdk/main/docs-site/public/videos/setup-claude-web.mp4" type="video/mp4" />
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Bug: New video URLs use an incorrect path format (main/ instead of refs/heads/main/), which will cause the CI link checker script to fail and block deployment.
Severity: CRITICAL

Suggested Fix

Update the new video and poster URLs in docs/mcp-server.mdx to use the refs/heads/main/ path instead of main/. This will align them with the existing pattern and allow the check-links.py script to correctly validate them.

Prompt for AI Agent
Review the code at the location below. A potential bug has been identified by an AI
agent.
Verify if this is a real issue. If it is, propose a fix; if not, explain why it's not
valid.

Location: docs/mcp-server.mdx#L29-L30

Potential issue: The pull request introduces new URLs for video assets using the
`.../main/...` path format. The continuous integration link checker script,
`check-links.py`, is configured with a `REPO_LFS_PREFIX` that expects a
`.../refs/heads/main/...` path to validate local files. Since the new URLs do not match
this prefix, the script will classify them as unrecognized external links. This will
trigger an error during the link check step, causing the deployment workflow to fail.

Did we get this right? 👍 / 👎 to inform future reviews.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant